@profullstack/coinpay 0.5.7 → 0.6.0

package/bin/coinpay.js

@@ -222,6 +222,9 @@ ${colors.cyan}Commands:${colors.reset}
     submit                Submit a task receipt
     query <agent-did>     Query agent reputation
     credential <id>       Get credential details
+    credentials [did]     List all credentials for a DID
+    receipts [did]        List all task receipts for a DID
+    badge [did]           Get embeddable reputation badge URL
     verify <id>           Verify a credential
     revocations           List revoked credentials
 
@@ -1785,9 +1788,112 @@ async function handleReputation(subcommand, args, flags) {
       break;
     }
 
+    case 'credentials': {
+      const did = args[0];
+      if (!did) {
+        // Try to get own DID
+        const { getMyDid } = await import('../src/reputation.js');
+        const myDid = await getMyDid(client);
+        if (!myDid?.did) {
+          print.error('Usage: coinpay reputation credentials <did>');
+          print.info('Or claim a DID first: coinpay reputation did claim');
+          process.exit(1);
+        }
+        const { getCredentials } = await import('../src/reputation.js');
+        const result = await getCredentials(client, myDid.did);
+        if (result.credentials && result.credentials.length > 0) {
+          print.success(`${result.credentials.length} credential(s) for ${myDid.did}:`);
+          for (const cred of result.credentials) {
+            print.info(`  ${cred.id} | ${cred.credential_type} | ${cred.revoked ? '❌ Revoked' : '✅ Active'} | ${new Date(cred.issued_at).toLocaleDateString()}`);
+          }
+        } else {
+          print.info('No credentials found. Complete escrow transactions to earn credentials.');
+        }
+        if (flags.json) print.json(result);
+      } else {
+        const { getCredentials } = await import('../src/reputation.js');
+        const result = await getCredentials(client, did);
+        if (result.credentials && result.credentials.length > 0) {
+          print.success(`${result.credentials.length} credential(s) for ${did}:`);
+          for (const cred of result.credentials) {
+            print.info(`  ${cred.id} | ${cred.credential_type} | ${cred.revoked ? '❌ Revoked' : '✅ Active'} | ${new Date(cred.issued_at).toLocaleDateString()}`);
+          }
+        } else {
+          print.info('No credentials found for this DID.');
+        }
+        if (flags.json) print.json(result);
+      }
+      break;
+    }
+
+    case 'receipts': {
+      const did = args[0];
+      if (!did) {
+        const { getMyDid } = await import('../src/reputation.js');
+        const myDid = await getMyDid(client);
+        if (!myDid?.did) {
+          print.error('Usage: coinpay reputation receipts <did>');
+          print.info('Or claim a DID first: coinpay reputation did claim');
+          process.exit(1);
+        }
+        const { getReceipts } = await import('../src/reputation.js');
+        const result = await getReceipts(client, myDid.did);
+        if (result.receipts && result.receipts.length > 0) {
+          print.success(`${result.receipts.length} receipt(s) for ${myDid.did}:`);
+          for (const r of result.receipts) {
+            print.info(`  ${r.receipt_id} | ${r.outcome} | $${r.amount || 0} ${r.currency || ''} | ${new Date(r.created_at).toLocaleDateString()}`);
+          }
+        } else {
+          print.info('No receipts found. Complete escrow transactions to generate receipts.');
+        }
+        if (flags.json) print.json(result);
+      } else {
+        const { getReceipts } = await import('../src/reputation.js');
+        const result = await getReceipts(client, did);
+        if (result.receipts && result.receipts.length > 0) {
+          print.success(`${result.receipts.length} receipt(s) for ${did}:`);
+          for (const r of result.receipts) {
+            print.info(`  ${r.receipt_id} | ${r.outcome} | $${r.amount || 0} ${r.currency || ''} | ${new Date(r.created_at).toLocaleDateString()}`);
+          }
+        } else {
+          print.info('No receipts found for this DID.');
+        }
+        if (flags.json) print.json(result);
+      }
+      break;
+    }
+
+    case 'badge': {
+      const did = args[0];
+      if (!did) {
+        const { getMyDid } = await import('../src/reputation.js');
+        const myDid = await getMyDid(client);
+        if (!myDid?.did) {
+          print.error('Usage: coinpay reputation badge <did>');
+          process.exit(1);
+        }
+        const { getBadgeUrl } = await import('../src/reputation.js');
+        const url = getBadgeUrl(client.baseUrl || 'https://coinpayportal.com', myDid.did);
+        print.success('Badge URL:');
+        print.info(`  ${url}`);
+        print.info('');
+        print.info('Markdown embed:');
+        print.info(`  ![Reputation](${url})`);
+      } else {
+        const { getBadgeUrl } = await import('../src/reputation.js');
+        const url = getBadgeUrl(client.baseUrl || 'https://coinpayportal.com', did);
+        print.success('Badge URL:');
+        print.info(`  ${url}`);
+        print.info('');
+        print.info('Markdown embed:');
+        print.info(`  ![Reputation](${url})`);
+      }
+      break;
+    }
+
     default:
       print.error(`Unknown reputation command: ${subcommand}`);
-      print.info('Available: submit, query, credential, verify, revocations, did');
+      print.info('Available: submit, query, credential, credentials, receipts, badge, verify, revocations, did');
       process.exit(1);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profullstack/coinpay",
-  "version": "0.5.7",
+  "version": "0.6.0",
   "description": "CoinPay SDK & CLI — Accept cryptocurrency payments (BTC, ETH, SOL, POL, BCH, USDC) with wallet and swap support",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -83,6 +83,9 @@ import {
   submitReceipt,
   getReputation,
   getCredential,
+  getCredentials,
+  getReceipts,
+  getBadgeUrl,
   verifyCredential,
   getRevocationList,
 } from './reputation.js';

package/src/reputation.d.ts

@@ -70,6 +70,39 @@ export function getCredential(client: CoinPayClient, credentialId: string): Prom
 export function verifyCredential(client: CoinPayClient, credential: { credential_id: string }): Promise<{ valid: boolean; reason?: string }>;
 export function getRevocationList(client: CoinPayClient): Promise<{ success: boolean; revoked_credentials: string[]; revocations: Array<Record<string, unknown>> }>;
 
+// CPTL Phase 2
+
+export type ActionCategory =
+  | 'economic.transaction' | 'economic.dispute' | 'economic.refund'
+  | 'productivity.task' | 'productivity.application' | 'productivity.completion'
+  | 'identity.profile_update' | 'identity.verification'
+  | 'social.post' | 'social.comment' | 'social.endorsement'
+  | 'compliance.incident' | 'compliance.violation';
+
+export interface ActionReceiptInput extends ReceiptInput {
+  action_category?: ActionCategory;
+  action_type?: string;
+}
+
+export interface TrustVector {
+  E: number;
+  P: number;
+  B: number;
+  D: number;
+  R: number;
+  A: number;
+  C: number;
+}
+
+export interface TrustProfileResult {
+  trust_vector: TrustVector | null;
+  reputation: ReputationResult | null;
+  computed_at: string | null;
+}
+
+export function submitActionReceipt(client: CoinPayClient, receipt: ActionReceiptInput): Promise<{ success: boolean; receipt?: Record<string, unknown>; error?: string }>;
+export function getTrustProfile(client: CoinPayClient, agentDid: string): Promise<TrustProfileResult>;
+
 export interface DidInfo {
   did: string;
   public_key: string;

package/src/reputation.js

@@ -102,3 +102,81 @@ export async function linkDid(client, { did, publicKey, signature }) {
     }),
   });
 }
+
+/**
+ * Get all credentials for a DID
+ * @param {import('./client.js').CoinPayClient} client
+ * @param {string} did - The DID to query credentials for
+ * @returns {Promise<Object>}
+ */
+export async function getCredentials(client, did) {
+  return client.request(`/reputation/credentials?did=${encodeURIComponent(did)}`);
+}
+
+/**
+ * Get all task receipts for a DID
+ * @param {import('./client.js').CoinPayClient} client
+ * @param {string} did - The DID to query receipts for
+ * @returns {Promise<Object>}
+ */
+export async function getReceipts(client, did) {
+  return client.request(`/reputation/receipts?did=${encodeURIComponent(did)}`);
+}
+
+// ═══════════════════════════════════════════════════════════
+// CPTL Phase 2 — Action Receipts & Trust Profile
+// ═══════════════════════════════════════════════════════════
+
+const CANONICAL_CATEGORIES = [
+  'economic.transaction', 'economic.dispute', 'economic.refund',
+  'productivity.task', 'productivity.application', 'productivity.completion',
+  'identity.profile_update', 'identity.verification',
+  'social.post', 'social.comment', 'social.endorsement',
+  'compliance.incident', 'compliance.violation',
+];
+
+/**
+ * Submit an action receipt with schema validation
+ * @param {import('./client.js').CoinPayClient} client
+ * @param {Object} receipt - Action receipt with action_category
+ * @returns {Promise<Object>}
+ */
+export async function submitActionReceipt(client, receipt) {
+  // Validate action_category if provided
+  if (receipt.action_category && !CANONICAL_CATEGORIES.includes(receipt.action_category)) {
+    throw new Error(`Invalid action_category: ${receipt.action_category}. Must be one of: ${CANONICAL_CATEGORIES.join(', ')}`);
+  }
+  // Default action_category
+  if (!receipt.action_category) {
+    receipt = { ...receipt, action_category: 'economic.transaction' };
+  }
+  return client.request('/reputation/receipt', {
+    method: 'POST',
+    body: JSON.stringify(receipt),
+  });
+}
+
+/**
+ * Get trust profile (trust vector) for an agent DID
+ * @param {import('./client.js').CoinPayClient} client
+ * @param {string} agentDid
+ * @returns {Promise<Object>} Trust vector { E, P, B, D, R, A, C }
+ */
+export async function getTrustProfile(client, agentDid) {
+  const result = await client.request(`/reputation/agent/${encodeURIComponent(agentDid)}/reputation`);
+  return {
+    trust_vector: result.trust_vector || null,
+    reputation: result.reputation || null,
+    computed_at: result.computed_at || null,
+  };
+}
+
+/**
+ * Get the badge URL for a DID
+ * @param {string} baseUrl - The CoinPayPortal base URL
+ * @param {string} did - The DID
+ * @returns {string} Badge SVG URL
+ */
+export function getBadgeUrl(baseUrl, did) {
+  return `${baseUrl}/api/reputation/badge/${encodeURIComponent(did)}`;
+}